home *** CD-ROM | disk | FTP | other *** search
/ PC World Komputer 2010 April / PCWorld0410.iso / hity wydania / Ubuntu 9.10 PL / karmelkowy-koliberek-desktop-9.10-i386-PL.iso / casper / filesystem.squashfs / usr / share / doc / libical0 / README < prev    next >
Encoding:
Text File  |  2009-01-08  |  3.6 KB  |  108 lines
  1.  
  2. LIBICAL -- an implementation of iCalendar protocols and data formats
  3.  
  4. Most of the code in here was written by Eric Busboom with help from
  5. dozens of contributors.  It is currently maintained by Art Cancro
  6. and Wilfried Goesgens.
  7.  
  8. The code and datafiles in this distribution are licensed under the
  9. Mozilla Public License.  See http://www.mozilla.org/NPL/MPL-1.0.html
  10. for a copy of the license.  Alternately, you may use libical under the
  11. terms of the GNU Library General Public License.  See
  12. http://www.fsf.org/copyleft/lesser.html for a copy of the LGPL.
  13.  
  14. This dual license ensures that the library can be incorporated into
  15. both proprietary code and GPL'd programs, and will benefit from
  16. improvements made by programmers in both realms.  We will only accept
  17. changes into the library if they are similarly dual-licensed.
  18.  
  19. Portions of this distribution are (C) Copyright 1996 Apple Computer,
  20. Inc., AT&T Corp., International Business Machines Corporation and
  21. Siemens Rolm Communications Inc. See src/libicalvcal/README.TXT for
  22. details.
  23.  
  24. Portions of this distribution are Copyright (c) 1997 Theo de
  25. Raadt.  See the header for src/libical/vsnprintf.c for the full
  26. copyright statement.
  27.  
  28. If you would like to contribute to this project, please visit the
  29. SourceForge page: http://freeassociation.sourceforge.net
  30.  
  31.  
  32. Building the library
  33. --------------------
  34.  
  35. This distribution is developed on CentOS Linux and should also
  36. build cleanly on any unix-like system as long as it has the usual
  37. set of open source build tools online.
  38.  
  39. The library is configured with automake. IF YOU ARE BUILDING THE
  40. SOURCE FROM A TARBALL, From the root directory, run
  41.  
  42.     ./configure
  43.  
  44. To build all of the Makefiles for your system. If you will be
  45. installing the library, you may want to use the --prefix flag to set
  46. the directory where the library and header files will be installed.
  47.  
  48.     ./configure --prefix=/proj/local/
  49.  
  50. If configure runs fine, run "make" to build the library and 
  51. "make install" to install it.
  52.  
  53. Although the distribution uses libtool to generate libraries, it has
  54. shared libraries turned off by default. To create and install shared
  55. libraries use:
  56.  
  57.     ./configure --enable-shared
  58.  
  59.  
  60. IF YOU ARE BUILDING FROM SVN, there will be no configure file until
  61. you create one with the "bootstrap" script.
  62.  
  63. The current version of libical focuses on creating and
  64. manipulating iCal objects. With it, you can parse text representations
  65. of iCal components, add and remove sub-components, properties,
  66. parameters and values, and print the components back out as strings. 
  67.  
  68.  
  69. Notes for Libical Developers
  70. ----------------------------
  71.  
  72. If you don't want to use gcc as the compiler, and you got the sources
  73. from SVN, you should set the CC variable to the path to the compiler
  74. and run "automake --include-deps" to keep automake from using
  75. gcc-specific automatic dependancy tracking.
  76.  
  77.         > CC=/pkg/SUNWspro/bin/cc; export CC
  78.         > automake --include-deps
  79.         > ./configure --prefix=/proj/local/
  80.         > make
  81.  
  82. You will not need to re-run automake unless you got the sources from SVN. 
  83.  
  84. When updating to a new release, tweak the version number in the following files:
  85. CMakeLists.txt
  86. configure.in
  87. src/libical/icalversion.h
  88. src/java/Makefile.am
  89. src/libicalcap/Makefile.am
  90. src/libical/Makefile.am
  91. src/libicalss/Makefile.am
  92. src/libicalvcal/Makefile.am
  93. src/java/CMakeLists.txt
  94. src/libicalcap/CMakeLists.txt
  95. src/libicalss/CMakeLists.txt
  96. src/libicalvcal/CMakeLists.txt
  97.  
  98.  
  99. Using the Library
  100. -----------------
  101.  
  102. There is rudimentary, unfinished documentation in the /doc directory,
  103. and annotated examples in /examples and the test code in src/test.
  104.  
  105. Sourcecode now in SVN
  106. ---------------------
  107. We now work in our SF.net SVN Repository. Please don't use the CVS anymore.
  108.